home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cmread51.zip / CMREADER.DOC < prev    next >
Text File  |  1992-11-13  |  12KB  |  414 lines
  1.  
  2.  
  3.            ██▒▒██▒▒██▒▒██▒▒██▒▒             CMReader 5.1
  4.            ▒▒██▒▒██▒▒██▒▒██▒▒██           copyright 1991-92     
  5.            ██▒▒██▒▒██▒▒██▒▒██▒▒        Knightware/Bud Bradley
  6.            ▒▒██▒▒██▒▒██▒▒██▒▒██     
  7.            ██▒▒██▒▒██▒▒██▒▒██▒▒     ChessMAGIC! Offline Game Viewer
  8.            ▒▒██▒▒██▒▒██▒▒██▒▒██
  9.            ██▒▒██▒▒██▒▒██▒▒██▒▒         
  10.            ▒▒██▒▒██▒▒██▒▒██▒▒██         
  11.  
  12.  
  13.  
  14.  
  15.                 REFERENCE MANUAL
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                  Distributed by
  26.  
  27.                    KnightWare
  28.                  P.O. Box 464711  
  29.                 Lawrenceville, GA   30246
  30.                 BBS (404) 978-2893
  31.                    24 hrs  14.4
  32.  
  33.                   
  34.                 
  35.              
  36.              
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.             Copyright (c)1991-1992 Bud Bradley/KnightWare
  54.                 All Rights Reserved 
  55.  
  56.  
  57.                    INTRODUCTION 
  58.  
  59.     
  60.     The ChessMAGIC! Offline Game Reader (e.g. CMReader) is being distributed  
  61.     as shareware and is completely functional. If you find this product
  62.     useful you are encouraged to register it. It not only provides the
  63.     author renumeration for his efforts, but insures continued support of
  64.     the product(s). Upon registering, the beg screen(s) will be removed.
  65.     
  66.     CMReader archive may be freely distributed as long as the contents remain 
  67.     intact and without modification. 
  68.      
  69.     CMReader provides the means to play back and study any chess game from a 
  70.     simple text format file.  The main benefits of CMReader, though, are 
  71.     derived when used in conjunction the BBS door ChessMAGIC! (registered 
  72.     versions).  Registered ChessMAGIC! versions enable users to download
  73.     games matching many and varied criteria for later offline study at their 
  74.     leisure. 
  75.     
  76.  
  77.                  W A R R A N T Y
  78.  
  79.     Users of the ChessMAGIC! Offline Game Reader (e.g. CMReader) must accept 
  80.     this disclaimer of warranty: 
  81.     
  82.     "CMReader is supplied as is.  The author disclaims all warranties, 
  83.     expressed or implied, including, without limitation, the warranties of 
  84.     merchantability and of fitness for any purpose. The author assumes no 
  85.     liability for damages, direct or consequential, which may result from the 
  86.     use of CMReader. 
  87.  
  88.     "In no event shall KnightWare be liable for any damages, including lost 
  89.     profits, lost savings or other incidental or consequential damages 
  90.     arising out of your use or inability to use CMReader, or for any claim by 
  91.     any other party. 
  92.  
  93.  
  94.              T a b l e    o f    C o n t e n t s
  95.  
  96.        Section    Title
  97.  
  98.      1.0      SYSTEM REQUIREMENTS
  99.  
  100.      2.0      INITIALIZATION
  101.  
  102.      3.0      COMMAND OPTIONS
  103.  
  104.      4.0      GAME FILE FORMAT
  105.      4.1        Rules & Guidelines
  106.  
  107.      5.0      PRODUCT SUPPORT
  108.      5.1        Product Distribution
  109.  
  110.      6.0      REGISTRATION FORM
  111.  
  112.        ╒═══════════════════════════════════════════════════════════════════╕
  113.        │   1.0   CMReader - SYSTEM REQUIREMENTS                            │
  114.        ╘═══════════════════════════════════════════════════════════════════╛
  115.  
  116.        PC/MS-DOS 2.11 or higher
  117.        360k Floppy Drive
  118.        200k RAM Minimum
  119.        Monitor with minimum EGA graphics capabilities
  120.  
  121.        ╒═══════════════════════════════════════════════════════════════════╕
  122.        │   2.0   CMReader - INITIALIZATION                                 │
  123.        ╘═══════════════════════════════════════════════════════════════════╛
  124.  
  125.        To override the mouse, if you have one and don't care to
  126.        use it, the following switch will turn it off.
  127.  
  128.       cmr -m
  129.  
  130.  
  131.        ╒═══════════════════════════════════════════════════════════════════╕
  132.        │   3.0   CMReader - Menu COMMAND OPTIONS                           │
  133.        ╘═══════════════════════════════════════════════════════════════════╛
  134.  
  135.        Function Keys-
  136.  
  137.        <F1> = HELP Screen
  138.      
  139.        Cursor Keys-
  140.  
  141.     Up    Arrow    = Highlights menu item
  142.     Down  Arrow    = Highlights menu item
  143.  
  144.        Mouse-
  145.  
  146.     Right Button   = Single Click highlights selection
  147.              Double Click processes selection
  148.  
  149.        Miscellaneous-
  150.  
  151.       <ENTER>      = Selects highlighted item
  152.        <ESC>       = Exits program.
  153.  
  154.  
  155.        ╒═══════════════════════════════════════════════════════════════════╕
  156.        │   3.1   CMReader - Path/File Selection COMMAND OPTIONS            │
  157.        ╘═══════════════════════════════════════════════════════════════════╛
  158.  
  159.        On the "Path:" line, enter the path where the games are located.
  160.        Do not enter any file specs, such as *.*. CMReader will auto
  161.        detect any game files in the path.
  162.  
  163.        Function Keys-
  164.  
  165.       <F1>         = HELP Screen
  166.       <F10>        = Selects highlighted file for viewing
  167.  
  168.        Cursor Keys-
  169.  
  170.     Up    Arrow    = Highlights file
  171.     Down  Arrow    = Highlights file
  172.     Right Arrow    = Highlights file
  173.     Left  Arrow    = Highlights file
  174.  
  175.        Mouse-
  176.  
  177.     Right Button   = Single Click highlights selection
  178.              Double Click selects file for viewing
  179.  
  180.        Miscellaneous-
  181.  
  182.       <ENTER>      = Changes to selected PATH
  183.        <ESC>       = Exits to menu
  184.       <HOME>       = Positions cursor to beginning of PATH
  185.        <END>       = Positions cursor to end of PATH
  186.  
  187.        ╒═══════════════════════════════════════════════════════════════════╕
  188.        │   3.2   CMReader - Viewing COMMAND OPTIONS                        │
  189.        ╘═══════════════════════════════════════════════════════════════════╛
  190.  
  191.        Function Keys-
  192.  
  193.        <F1> = HELP Screen
  194.        <F2> = Invert Board
  195.        <F3> = Auto-Play ON (approximately 1 move per second)
  196.           Pressing any key will turn off auto-play.
  197.      
  198.        Cursor Keys-
  199.  
  200.     Right Arrow    = Next Move
  201.     Left  Arrow    = Take Back Move
  202.        <HOME>      = Reset board to 1st move, clearing all Marked moves
  203.        <END>       = Goes to the end of the move list, and displays
  204.              board position as of the last move.
  205.  
  206.  
  207.        Mouse
  208.  
  209.        Click on the Selection at the bottom of the screen
  210.  
  211.        Miscellaneous-
  212.  
  213.        <ESC>       = Exit current screen
  214.        < - >       = Minus Key slows down auto play
  215.        < + >       = Plus Key speeds up auto play
  216.  
  217.      * Denotes holding down the <Alt> key and pressing the associated
  218.        letter.
  219.  
  220.        ╒═══════════════════════════════════════════════════════════════════╕
  221.        │   4.0   CMReader - GAME FILE FORMAT                               │
  222.        ╘═══════════════════════════════════════════════════════════════════╛
  223.  
  224.        The file MUST be in standard ASCII text form and contain NO embedded
  225.        control codes, extended ASCII characters, etc.  Refer to your word
  226.        processor or text editor documentation on how to generate this type of
  227.        file.
  228.  
  229.        Only ONE game per file and the contents would be similar to the
  230.        following example of a partial game:
  231.  
  232.        #White:BUD BRADLEY          (1711)
  233.        #Black:FREDDY FISH      L1  (1305)
  234.        #These are the game headers and can be up to 3 lines.
  235.        1. f2-f4  b8-c6
  236.        @This is a non-displayed comment.
  237.        2. g1-f3  g8-f6
  238.        <This is a Black-Side comment
  239.        <and can be up to
  240.        <3 lines of 79 characters each.
  241.        3. b2-b3  f6-d5
  242.        >This is a White-side comment
  243.        >and can be up to
  244.        >3 lines of 79 characters each.
  245.  
  246.        ╒═══════════════════════════════════════════════════════════════════╕
  247.        │   4.1   CMReader - Game File Format Rules & Guidelines            │
  248.        ╘═══════════════════════════════════════════════════════════════════╛
  249.  
  250.        Comment Lines-
  251.  
  252.            # = Game headers. Always 1st 3 lines in the game file.
  253.            line 1 = white player
  254.            line 2 = black player
  255.            line 3 = dates, location, etc.
  256.            @ = invisible (never displays)
  257.            > = Display After White-side Move
  258.            < = Display After Black-side Move
  259.  
  260.        Comments may be up to 79 characters per line with a maximum of 3
  261.        contiguous lines prior to a move entry.  A comment character must
  262.        be placed in the first column for it to be recognized as such by
  263.        CMReader.
  264.  
  265.     Notation-
  266.  
  267.            Long  Algebraic       :   e2-e4
  268.            Short Algebraic       :   e4, Nf3, Nbd2, R1a2 etc..
  269.  
  270.        
  271.     Move Separator-
  272.        
  273.        These can be any of the following:
  274.        
  275.            e2-e4   e2;e4   e2xe4
  276.         
  277.        The x is normally only used to designate captures. 
  278.  
  279.     Move Numbers-
  280.  
  281.        Each White/Black move pair MUST have a line to themselves and 
  282.        preceeded with a move number.
  283.        
  284.            Correct-
  285.        
  286.              1 e2-e4  g7-g6
  287.           or
  288.              1. e2-e4  g7-g6
  289.  
  290.        ╒═══════════════════════════════════════════════════════════════════╕
  291.        │   4.1   CMReaader - Game File Format Rules & Guidelines           │
  292.        ╘═══════════════════════════════════════════════════════════════════╛
  293.  
  294.            Incorrect-
  295.  
  296.              1 e2-e4
  297.              g7-g6
  298.           or
  299.              e2-e4
  300.              g7-g6
  301.           or
  302.              23.
  303.        
  304.        The last incorrect example shows a move number that lacks a 
  305.        corresponding move entry.
  306.  
  307.        Note: The "." (i.e. period) is ignored by CMReader, so can either 
  308.        be included or excluded, whichever you prefer. 
  309.         
  310.  
  311.     Result Designation-
  312.  
  313.            Draw         =   draw
  314.            Resignation  =   1-0 or 0-1 or resigns
  315.            Mate         =   mate
  316.        
  317.        Examples: 
  318.        
  319.            23. c1-e1 draw   
  320.            23  c1-e1 resig  or   23 c1-e1 1-0  or  23 c1-e1 0-1
  321.            23. c1-e1 mate   
  322.  
  323.     Pawn Promotion-
  324.  
  325.            =Q   Queen
  326.            =R   Rook
  327.            =N   Knight
  328.            =B   Bishop
  329.  
  330.        The promotion is designated immediately following the move.  
  331.        Example, promoting a Pawn to a Queen:
  332.        
  333.            23. g7-g8=Q
  334.  
  335.     Exclamatory Signs-
  336.  
  337.            +    !    ?
  338.  
  339.        White and Black moves can contain up to 2 signs each, as shown:
  340.  
  341.            15 c2-c4!?  f8-b4+
  342.  
  343.  
  344.        ╒═══════════════════════════════════════════════════════════════════╕
  345.        │   5.0   PRODUCT SUPPORT                                           │
  346.        ╘═══════════════════════════════════════════════════════════════════╛
  347.  
  348.        Questions or inquiries can be directed to us through any of the
  349.        following sources:
  350.  
  351.                   * E-MAIL CONTACTS *
  352.                       and
  353.                All BBS-Related Questions
  354.  
  355.                   KnightWare BBS
  356.                   (Atlanta, GA)
  357.                (404) 978-2893  1200/2400
  358.  
  359.  
  360.                    * US MAIL *
  361.  
  362.                    KnightWare
  363.                 P.O. Box 464711  
  364.                 Lawrenceville, GA   30246
  365.  
  366.  
  367.     ╒════════════════════════════════════════════════════════════════════╕
  368.     │   5.1   Distribution Hubs for ChessMAGIC!                          │
  369.     ╘════════════════════════════════════════════════════════════════════╛
  370.  
  371.     1)   TDS International Network (Eugene, OR)
  372.      Worldwide distributor of PCBoard Doors & Utilities
  373.      (503) 342-4447 (HST  14.4k,  8/n/1)
  374.      (503) 342-4448 (Supra v.32,  8/n/1)
  375.  
  376.     2)   Atlanta Chess BBS (Atlanta, GA)
  377.      (404) 978-2893 (14.4k 24 hours)
  378.  
  379.  
  380.        ╒═══════════════════════════════════════════════════════════════════╕
  381.        │   6.0   MAIL-IN ORDER FORM   (check or money orders)              │
  382.        ╘═══════════════════════════════════════════════════════════════════╛
  383.  
  384.  Make Checks Payable to:  KnightWare
  385.               P.O Box 464711   
  386.               Lawrenceville, GA   30246
  387.  
  388.  
  389.  Your Name    ________________________________
  390.           
  391.       Phone   ________________________________  (Voice)
  392.  
  393.       Address ________________________________
  394.           
  395.       Address ________________________________
  396.  
  397.       City    ________________  State ____  ZIP ______________ 
  398.  
  399.  
  400.      PRODUCT                          QUANTITY  PRICE EA.   TOTAL PRICE 
  401.  ---------------------------          --------  ---------   -----------
  402.  
  403.  CMReader - Offline Game Viewer       ________ x  $ 10.00 = ___________
  404.                                     
  405.   
  406.                         Sub-Total       ___________ 
  407.                                      
  408.             Shipping & Handling                   $  1.50 
  409.                                     
  410.                         TOTAL 
  411.                                 =========== 
  412.  
  413.  
  414.